home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / dbase / cm110.zip / CM.TXT next >
Text File  |  1992-11-16  |  16KB  |  473 lines
  1. Cable Master User Documentation
  2.  
  3. This is the freeware version of the CableMaster Software. You are free to 
  4. make copies of this software so long as no modifications are made.
  5.  
  6. This software is **not** in the public domain and remains the exclusive
  7. property of Houston Computer Services, Inc.; 3207 Ashfield Drive;
  8. Houston TX 77082 USA; voice: (713)493-9900. fax: (713)558-1880.
  9.  
  10. The CableMaster hardware is available for purchase. An order form has been
  11. included with this software. Contact Houston Computer Services for more 
  12. information.
  13.  
  14.  
  15.  
  16.  
  17. Introduction
  18.  
  19. There are literally thousands of possible cables used to make connections 
  20. between terminals, PCs, printers, modems, and other types of serial 
  21. communication devices.
  22.  
  23. End users, systems integrators, and service technicians are frequently 
  24. called on to find the correct wiring configuration for cables between two 
  25. different devices. Often a similar cable may have already been configured 
  26. or an existing cable may already be in use.
  27.  
  28. The Cable Master system makes it easy to look inside a cable to see how it 
  29. is wired and to document which cable is supposed to do what.
  30.  
  31.  
  32.  
  33. The Package
  34.  
  35. The Cable Master package allows an IBM PC (or compatible including the 
  36. PS/2) to examine cables to determine the exact internal wiring of the 
  37. cable.
  38.  
  39. Attaching to the serial port of the PC, the hardware is a small black box 
  40. with cable-scanning circuitry that checks for continuity with each and 
  41. every pin on the cable to determine exactly how each pin is used.
  42.  
  43. The Cable Master software determines the wiring diagram for the cable. 
  44. The diagram is compared to a list of commonly encountered cables and 
  45. may be displayed on the screen of the PC or printed to the PC's printer.
  46.  
  47. The Cable Master package consists of two parts: the ID200H cable
  48. -scanning hardware and the Cable Master software. The user supplies an 
  49. IBM PC, PS/2, or compatible and the DOS operating system.
  50.  
  51. The package installs in less than a minute without tools (and without 
  52. turning off the PC or opening its case). Simply attach the hardware to the 
  53. PC's serial port and load the Cable Master software from the diskette.
  54.  
  55.  
  56.  
  57. The Hardware
  58.  
  59. The ID200H hardware is a cable-scanning test instrument which operates 
  60. under the control of software on an IBM PC, PS/2, or compatible. 
  61. Specifically designed to scan and test cables, the hardware attaches to 
  62. the serial port of an IBM PC.
  63.  
  64. There are three connectors on the ID200H hardware. The host port 
  65. connector (at the end of the RS232 cable) connects to the serial port of 
  66. the PC. The hardware uses this connection to communicate with the PC and 
  67. the Cable Master software. This connection also provides power to the 
  68. Cable Master hardware.
  69.  
  70. The hardware uses five of the signals on the serial interface to operate. 
  71. These signals are:
  72.  
  73.     TD      2       power to scanner
  74.     RTS     4       data to scanner
  75.     DSR     6       data from scanner
  76.     DTR     20      data to scanner
  77.     GROUND  7       signal ground
  78.  
  79. There are two 25-pin test connectors. (One of these connectors is labeled 
  80. A, the other is labeled B.) The hardware examines each pin on the test 
  81. connectors, looking for continuity (that is, a hard-wired connection) with 
  82. any of the other pins on either the A or B connectors.
  83.  
  84. The wiring of each cable is unique and is determined by the needs of the 
  85. communication devices which it connects. By checking for continuity, the 
  86. Cable Master hardware can quickly determine the complete wiring of the 
  87. cable (much like a technician might do using a break-out box or by Ohming 
  88. out the cable using a hand-held meter).
  89.  
  90. This pin-to-pin continuity information is used by the Cable Master 
  91. software to display the wiring diagram for the scanned cable.
  92.  
  93.  
  94.  
  95. The Software
  96.  
  97. The Cable Master hardware is controlled by software operating on the PC. 
  98.  
  99. Most software fits into one of two categories: simple or sophisticated. 
  100. There are two different programs provided with the Cable Master 
  101. hardware.  Cable Master 1 ("CM1") is simple. This program provides an 
  102. easy-to-use, one-screen interface to the Cable Master hardware. Cable 
  103. Master 2 ("CM2") is sophisticated. This program uses a mouse-oriented, 
  104. windowed user interface to provide a maximum of user capability.
  105.  
  106.  
  107.  
  108. The CM1 Software
  109.  
  110. The Cable Master 1 software is a program (called CM1.EXE) that operates 
  111. on an IBM PC (or compatible). This software has the following features:
  112.  
  113.     . Easy-to-use, one-screen user interface
  114.     . Scan and identify any cable
  115.     . Compare to other cables stored in a disk file
  116.     . Each disk file may store up to 70 cable descriptions
  117.     . Compact software that easily fits on one floppy diskette
  118.  
  119.  
  120.  
  121. Installing the CM1 Software
  122.  
  123. The Cable Master 1 software does not have an installation procedure. The 
  124. software on the diskette is ready for immediate use. Users may find it 
  125. easier to copy the Cable Master software to a directory on a hard disk. 
  126. This may be done by using the DOS COPY command. For example, insert the 
  127. Cable Master diskette in drive A and do the following commands:
  128.  
  129.     C:> MKDIR C:\CM1
  130.     C:> CD A:\CM1
  131.     C:> COPY A:*.* C:\CM1
  132.  
  133. There are two files on the Cable Master diskette used by CM1:
  134.  
  135.     CM1.EXE         The executable Cable Master 1 program.
  136.     CM1.HLP         This help file.
  137.  
  138.  
  139.  
  140. The Command Line
  141.  
  142. To use the CM1 program, type the program name at the DOS command 
  143. prompt. For example:
  144.  
  145.     C:> CM1
  146.  
  147.  
  148.  
  149. The Disk File
  150.  
  151. Selects the disk file used by the software. The disk file is used to match 
  152. the cables being tested to other (previously defined and tested) cables. 
  153. The default file is CM1.DAT in the current directory.
  154.  
  155. Examples:
  156.  
  157.     C:> CM1 filename        -or-
  158.     C:> CM1 a:\filename
  159.  
  160.     where filename is any file available on any drive. If the file 
  161.     does not exist, one will be created.
  162.  
  163.  
  164.  
  165. The Serial Port
  166.  
  167. Identifies the serial port parameter to which the cable scanning hardware 
  168. is attached. Ports from 1 to 4 may be used. The software will 
  169. automatically search all of the available ports, looking for the Cable 
  170. Master hardware. To re-do this search, press [altW]. To review all of the 
  171. available serial ports, press [altC].
  172.  
  173. Examples:
  174.  
  175.     C:> CM1 /3              -or-
  176.     C:> CM1 filename /3     -or-
  177.     C:> CM1 /3 filename
  178.  
  179.  
  180. The Display
  181.  
  182. The display of the CM1 program is divided into four main groups: the list 
  183. of cables, the wire list, the cable diagram and the message area. The 
  184. bottom line of the display shows some of the active keys. The top right 
  185. hand corner of the display shows the version level of the software.
  186.  
  187.  
  188.  
  189. The List Of Cables
  190.  
  191. The list of the cables stored in the disk file. Use the up and down arrow 
  192. keys the select a particular cable.
  193.  
  194. When selected, the name for the cable is highlighted and the wire list and 
  195. cable diagram are displayed. If the wire list or diagram is too large to be 
  196. displayed on the screen, use the left or right arrow keys to move the 
  197. cursor to that area of the screen, and the up and down arrows to display 
  198. the additional parts of the list or diagram.
  199.  
  200.  
  201.  
  202. The Wire List
  203.  
  204. Shows the wire list for the selected cable. Wire lists are of the format 
  205. Ax,Ay,Bx,By where A indicates the first or A side of the cable, B indicates 
  206. the second or B side of the cable and x and y are the pin numbers on that 
  207. particular side.
  208.  
  209.  
  210.  
  211. The Cable Diagram
  212.  
  213. Shows the diagram for the selected cable. Cable diagrams are of the 
  214. format  x ----- y, where x indicates the pin number on the A side and y 
  215. indicates the pin number on the B side.
  216.  
  217.  
  218.  
  219. Scanning The Cable
  220.  
  221. Use the [F4] key to scan and identify a cable. Scanning a cable takes a snap
  222. -shot of the cable currently mounted on the Cable Master hardware and 
  223. stores a copy of the wiring diagram into working memory within the PC.
  224.  
  225. The scanned cable is compared to the list of cables. If a match is found, 
  226. the cursor is positioned to the first cable in the list that matches the 
  227. scanned cable. If no match is found, a new cable (called ///new cable///) 
  228. is added to the end of the list of cables.
  229.  
  230. Use [Ins] to change the name of a cable.Use [Del] to delete a cable.
  231.  
  232.  
  233.  
  234. Saving The Data
  235.  
  236. Use the [F2] key to save data to the input disk file. No changes to the disk 
  237. file are made unless the [F2] key is pressed.
  238.  
  239.  
  240.  
  241. Printing The Cable Diagram
  242.  
  243. Use the [F3] key to print a description of the selected cable to the printer. 
  244. (If the printer does not support the IBM character set, use /A on the 
  245. command line or press [altA] once.)
  246.  
  247.  
  248.  
  249. Messages
  250.  
  251. The Cable Master 1 software will occasionally display messages during 
  252. its operation. This is a list of those messages, along with a brief 
  253. explanation of their meaning:
  254.  
  255.     MATCH           During SCAN, the scanned cable exactly matches 
  256.             the indicated cable.
  257.  
  258.     REVERSED        During SCAN, the scanned cable exactly matches 
  259.             the indicated cable, but End A and End B are 
  260.             reversed. (The cable is mounted on the Cable 
  261.             Master hardware backwards.)
  262.  
  263.     NO MATCH        During SCAN, the scanned cable does not exactly 
  264.             match any cable in the list. A new cable (called 
  265.             ///new cable///) has been added to end of the list.
  266.  
  267.     NO WIRES        The Cable Master hardware detected a cable without 
  268.             wires (probably, no cable is mounted).
  269.  
  270.     NEW FILE        The input disk file does not exist. If [F2] is used, 
  271.             a new disk file will be created. (A default list of 
  272.             cables has been used.)
  273.  
  274.     ERROR DURING 
  275.     WRITE           The disk file could not be written (by [F2]). Correct 
  276.             the problem and try again.
  277.  
  278.     ERROR DURING 
  279.     SCAN,
  280.     NO DEVICE       The Cable Master hardware did not respond. Either the 
  281.             hardware is not attached or the serial port is not 
  282.             correctly identified. (Use /2 /3 or /4 on the command 
  283.             line).
  284.  
  285.     OUT OF MEMORY   There is not enough available memory in this PC to 
  286.             run the CM1 program. Delete some memory resident 
  287.             programs, reboot the PC, or otherwise get more 
  288.             application memory before restarting the CM1 program. 
  289.             (CM1 needs less than 128k to run.)
  290.  
  291.     FILE READ 
  292.     ERROR           The input disk file could not be read. Correct the 
  293.             problem and try again.
  294.  
  295.  
  296.  
  297. The CM2 Software
  298.  
  299. The Cable Master 2 software is a program (called CM2.EXE) that operates 
  300. on an IBM PC (or compatible). This software has the following features:
  301.  
  302.     . Windowed, mouse-oriented user interface
  303.     . Scan and identify any cable
  304.     . Compare to other cables stored in a data base
  305.     . Each data base stores an unlimited number of cable descriptions
  306.  
  307.  
  308.  
  309. Installing The CM2 Software
  310.  
  311. The Cable Master 2 software does not have an installation procedure. The 
  312. software on the diskette is ready for immediate use. Users may find it 
  313. easier to copy the Cable Master software to a directory on a hard disk. 
  314. This may be done by using the DOS COPY command. For example, insert the 
  315. Cable Master diskette in drive A and do the following commands:
  316.  
  317.     C:> MKDIR C:\CM2
  318.     C:> CD A:\CM2
  319.     C:> COPY A:*.* C:\CM2
  320.  
  321. There are five files on the Cable Master  diskette used by CM2:
  322.  
  323.     CM2.EXE         The executable Cable Master 2 program.
  324.     CM2.HLP         The CM2 context-sensitive help file.
  325.     CM2.DAT         The default CM2 data base of cables.
  326.     CM2.IX          The index to the CM2.DAT file.
  327.     CM2.CFG         The CM2 configuration file.
  328.  
  329.  
  330. The Command Line
  331.  
  332. To use the CM2 program, type the program name at the DOS command 
  333. prompt. For example:
  334.  
  335.     C:> CM2
  336.  
  337.  
  338. The Display
  339.  
  340. The display of the CM2 program is windowed. The main menu (the Selector) 
  341. appears whenever a data base is opened.
  342.  
  343. The top line of the screen consists of pull-down menus. The bottom line of 
  344. the display shows some of the active keys.
  345.  
  346.  
  347.  
  348. The Selector
  349.  
  350. When a data base is opened, the Selector appears on the screen. Use the 
  351. Selector to scan cables using the Cable Master hardware, to display or 
  352. print cable descriptions, and to enter or to edit cable descriptions into the 
  353. Cable Master data base.
  354.  
  355. The Selector consists of a list of cables, a view selection box, an 
  356. information box, and a set of action buttons.
  357.  
  358.  
  359.  
  360. The List Of Cables
  361.  
  362. The list of the cables stored in the data base. Use the up and down arrow 
  363. keys the select a particular cable.
  364.  
  365.  
  366.  
  367. The View Selection Box
  368.  
  369. Use the selections in the view box to control which cables are displayed in 
  370. the list of cables.
  371.  
  372.  
  373.  
  374. The Information Box
  375.  
  376. This box shows the relationship of the selected cable to the scanned cable.
  377.  
  378.  
  379.  
  380. Scan A Cable
  381.  
  382. Use the SCAN BUTTON to scan and identify a cable. Scanning a cable takes 
  383. a snap-shot of the cable currently mounted on the Cable Master hardware 
  384. and stores a copy of the wiring diagram into working memory within the 
  385. PC.
  386.  
  387. The scanned cable is compared to the list of cables. If a match is found, 
  388. the cursor is positioned to the first cable in the list that matches the 
  389. scanned cable. If no match is found, a new cable (called *** unknown cable 
  390. ***) is added to the list of cables.
  391.  
  392. Use the EDIT BUTTON to enter additional information about the scanned 
  393. cable, including a name and description.
  394.  
  395.  
  396.  
  397. Display A Cable Diagram
  398.  
  399. Use the DISPLAY BUTTON to view the cable diagram and wire list of the 
  400. selected cable. (The cable diagram and wire list are placed in a new 
  401. window.)
  402.  
  403. Cable diagrams are of the format  x ----- y, where x indicates the pin 
  404. number on the A side and y  indicates the pin number on the B side.
  405.  
  406. Wire lists are of the format Ax,Ay,Bx,By where A indicates the first or A 
  407. side of the cable, B indicates the second or B side of the cable and x and y 
  408. are the pin numbers on that particular side.
  409.  
  410.  
  411.  
  412. Printing A Cable Diagram
  413.  
  414. Use the PRINT BUTTON to print a description of the selected cable to the 
  415. printer. Either a PURCHASE ORDER or a CABLE DESCRIPTION may be printed.
  416.  
  417.  
  418.  
  419. Edit/Add/Copy/Delete
  420.  
  421. Use these buttons to modify the details of the cable description including 
  422. the connectors, wiring list and textual descriptions.
  423.  
  424.  
  425.  
  426. The Data Base
  427.  
  428. The data base is used to match the cables being tested to other 
  429. (previously defined and tested) cables. There may be many different data 
  430. bases stored on disk, but only one data base may be in use at any given 
  431. time.
  432.  
  433. A data base is stored as two DOS files, one with a DAT extension and one 
  434. with an IX extension. When a backup is made, a file with the extension OUT  
  435. is used. Use Open on the File menu to select a data base.
  436.  
  437.  
  438.  
  439. Saving The Data
  440.  
  441. The data base is continuously saved to disk whenever changes are made. 
  442. Occasionally, use the Backup command on the File menu to store a backup 
  443. copy of the changes made.
  444.  
  445.  
  446.  
  447. Setup
  448.  
  449. Use the Setup pull-down menu to select the serial port, to enter company 
  450. and vendor information, to identify adapters, to add or edit connectors, 
  451. and to select the printer.
  452.  
  453. Select the serial port to which the Cable Master hardware is attached.
  454.  
  455. Select the correct adapter whenever one is mounted on the Cable Master 
  456. hardware.
  457.  
  458.  
  459.  
  460. Messages
  461.  
  462. The Cable Master 2 software will occasionally display messages during 
  463. its operation. This is a list of those messages, along with a brief 
  464. explanation of their meaning:
  465.  
  466.     NO WIRES        The Cable Master hardware detected a cable without 
  467.             wires (probably, no cable is mounted).
  468.  
  469.     NO DEVICE       The Cable Master hardware did not respond. Either the
  470.             hardware is not attached or the serial port is not 
  471.             correctly identified.
  472.  
  473.